Organisation AI Sources de recette · paquets privés

Références · Édition du 14 novembre 2026

API REST et serveur MCP

Les intégrations externes utilisent une clé Studio oia_ avec droits explicites. Elles ne doivent pas réutiliser une clé de fournisseur IA. Le contrôle actuel exige le module Studio, associé dans le code à l’offre Sur mesure ; cela ne fixe pas un prix commercial validé.

Créer et révoquer une clé

Un administrateur crée une clé dans Studio en choisissant les droits minimaux. La clé complète n’est montrée qu’à la création ; la base en conserve une empreinte. Conserver la valeur dans un coffre. Révoquer la clé dans Studio pour interrompre ses appels suivants. Une clé ancienne sans périmètre explicite conserve la lecture seule historique ; préférer une nouvelle clé limitée.

Toutes les requêtes partent vers l’instance choisie, avec Authorization: Bearer suivi de la clé. En réseau, utiliser HTTPS. Ne pas placer la clé dans les paramètres de l’URL ou dans le code d’une page web publique. La limite actuelle est de 60 appels par minute et par clé, comptabilisés en mémoire du processus, pas un quota distribué entre serveurs.

REST en lecture

Méthode et routeDroit requisRéponse
GET /api/v1/clientsread:clientsObjet data contenant la liste
GET /api/v1/documentsread:documentsDevis, factures et avoirs de l’organisation
GET /api/v1/tasksread:tasksTâches de l’organisation
GET /api/v1/membersread:membersPersonnes réduites aux champs autorisés, sans salaires
GET /api/v1/transactionsread:transactionsOpérations ; liste vide si module compta absent

Aucune route REST d’écriture /api/v1 n’est implémentée. Ces routes ne proposent pas de contrat de pagination ou de filtrage documenté ici. Les réponses métier peuvent évoluer : traiter les champs absents et épingler la version de son intégration.

Exemple Python de lecture

Définir ORGIA_URL avec l’adresse réelle de son instance et ORGIA_API_KEY dans un environnement protégé. Le script ci-dessous ne les affiche pas.

import json, os, urllib.request
base = os.environ['ORGIA_URL'].rstrip('/')
request = urllib.request.Request(
    base + '/api/v1/clients',
    headers={'Authorization': 'Bearer ' + os.environ['ORGIA_API_KEY']})
with urllib.request.urlopen(request, timeout=15) as response:
    clients = json.load(response)['data']
print('Nombre de clients :', len(clients))

MCP sur HTTP

Le serveur expose POST /mcp, JSON-RPC, avec le même en-tête d’authentification. Version de protocole annoncée : 2025-03-26. Méthodes présentes : initialize, ping, tools/list et tools/call. Une notification sans id reçoit HTTP 202 ; une erreur d’outil peut être HTTP 200 avec isError=true : examiner le corps de la réponse.

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
OutilDroit
list_clientsread:clients
list_documentsread:documents
list_tasksread:tasks
list_membersread:members
list_transactionsread:transactions
create_taskwrite:tasks
create_clientwrite:clients

Exemple d’appel d’écriture à exécuter seulement dans son environnement de test et avec autorisation :

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"create_task","arguments":{"title":"Vérifier la sauvegarde"}}}

create_task attend title ; due au format AAAA-MM-JJ et member_id sont facultatifs. create_client attend name ; email, contact et phone sont facultatifs. tools/list renvoie le schéma réellement accessible à la clé. Aucun serveur stdio, OAuth MCP, abonnement SSE ou compatibilité avec tout client MCP n’est garanti par cette implémentation HTTP.

Codes et isolation

401 : clé absente ou invalide. 402 : module Studio non accessible. 403 : périmètre manquant. 404 : ressource inconnue. 429 : trop d’appels. Les lectures et créations restent liées à l’organisation de la clé. Une réponse JSON-RPC peut signaler son erreur dans error ou content/isError ; ne pas déduire une réussite du seul statut HTTP.

Documentation préparée pour publication. Logiciel et accès web en recette privée ; aucun accès public ouvert par ce portail.